TURBO DISK 


TURBO DISK is a machine code utility which helps you get the most out 
of your 1541 disk drive. The main features are: 


load, save and verify programs up to 5 times faster 

make disk backups in under 4 minutes using a single 1541! 
all disk commands are shorter and easier to use 
compatible with the MIKRO ASSEMBLER cartridge 

parallel printer driver 
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TURBO DISK is designed to be compatible with all BASIC programs and 
also with machine code programs that access the disk drive using the 
official kernal routines. However some programs will use the same 
area of memory as TURBO DISK and may not be compatible. 


LOADING TURBO DISK 


To load TURBO DISK, insert the disk into the 1541 disk drive and type: 


LOAD ":*",8 <RETURN> then RUN <RETURN> 


FAST LOADING & SAVING 


First of all, you don't need to learn any new commands if you don't 
want to. Once TURBO DISK has been initialised you can load, save and 
verify programs at high speed without even thinking about it! Just 
use the commands LOAD, SAVE, and VERIFY as you would normally. 


TURBO DISK does have some different commands that you can use to save 
typing (and even more time), for example: 


BASIC command TURBO DISK command 
LOAD "PROGRAM" ,8 / PROGRAM 
LOAD "PROGRAM" ,8,1 %PROGRAM 
SAVE "PROGRAM" ,8 <PROGRAM 
VERIFY "PROGRAM" ,8 ! PROGRAM 


The TURBO DISK verify command will terminate immediately if it finds 
an error; standard BASIC will read right to the end of the file even 
if the very first’ byte is incorrect! 


There are two more commands that will save time when you want to load 
and run a program: TPROGRAM will LOAD, then RUN a program (all with 
one simple command). &PROGRAM will load a machine code program and 
execute it - equivalent to LOAD followed by SYS - but the SYS address 
must be the first byte of the program, 


FAST BACKUP 


With TURBO DISK you can make a backup copy of a disk using a single 
1541 disk drive - in under four minutes! Just type £B, then insert 
the source disk (the one you are copying from) and the destination 

disk (the one you are copying to) when prompted by TURBO DISK. 


The destination disk must be formatted first (see FAST FORMAT below). 
Its name will be changed to that of the source disk but its ID will be 
preserved. Any other information already on the disk will be lost. 
Nearly all of the Commodore 64's memory is used during a backup, 
including most of the area used by BASIC programs. If a BASIC program 
in memory is likely to be overwritten, TURBO DISK will stop and ask 
you to confirm whether you still wish the backup to go ahead. Type Y¥ 
to continue with the backup (and lose your program). Type N to keep 
your program and abandon the backup. 


FAST FORMAT | 


TURBO DISK allows you to format a disk at high speed - around 20 
seconds. For example, £N:MYDISK,Al will format a disk with the ID 
'Al' and the name 'MYDISK'. The increase in speed is achieved by 
sidestepping much of the error checking that normally takes place when 
a disk is formatted, so you should not use the fast format command if 
you think that a disk may be faulty. 


FAST COPY 


TURBO DISK allows you to copy a single file from one disk to another. 
As with the backup you will be told when to insert each disk. Program 
(PRG), sequential (SEQ), and some user (USR) files can all be copied 
using this command, providing that there is sufficient memory 
available. Files of up to 180 blocks can be copied when there is no 
program in memory, but otherwise the maximum file size will be reduced 
by the length of the program. If there is insufficient memory an OUT 
OF MEMORY error will be displayed. 


The fast copy command is very simple, for example £C:DATA will copy 
the file 'DATA' from the source disk to the destination disk. The 
copy will be created with the same name as the original. You can abort 
the copy by pressing the STOP key when prompted to insert the 
destination disk. To copy a sequential or user file you must specify 
the file type by adding ',S' or ',U' after the filename. 


PATTERN MATCHING 


Most disk commands (but not FAST COPY) allow pattern matching when 
specifying a file name: 


* is used to denote that the rest of the name is 
insignificant. For example, PROG* will match PROG, PROGRAM, 
PROG1, PROGRESS and so on. 


? is used as a wild card. Hence, ??0G would find PROG, FROG, 
CLOG etc, but not LOG. 


* and ? can be used in combination if required. 


PROGRAMMING COMMANDS 


Commodore supply a program called DOS SUPPORT which provides 
abbreviated disk commands but is incompatible with many other 
programs. TURBO DISK offers an enhanced package of commands, 
implemented in such a way that they are compatible with a higher 
proportion of programs. 


All TURBO DISK DOS commands are preceded by an @ symbol. Most of the 
commands are just abbreviations of the commands available through the 
disk command channel with OPEN 1,8,15: PRINT#1,"<command>". 


DISPLAY DISK ERROR MESSAGE 

If a disk error has occured the red LED on the disk drive flashes 
rapidly. Use this command to display the disk error channel message. 
The message is displayed in the form: number, message, track, sector - 
for example, 23,READ ERROR, 18,13. For more information about error 
messages you should refer to your disk drive manual. 


TURBO DISK command: @ 

BASIC equivalent: 10 OPEN 1,8,15 
20 INPUT#1,A$,B$,C$,D$ 
30 PRINT AS$;B$;C$;D$ 
40 CLOSE 1 


DISPLAY DISK DIRECTORY 
This command will display the directory of a disk on the screen 
without disturbing any program in memory. 


TURBO DISK command: @$ 
BASIC equivalent: LOAD"$",8 then LIST 


You can use pattern-matching to display part of the disk directory, 
for example @$:R* will display only filenames which begin with R. 
@$:R*,S* would display files beginning with R or S. 


CHANGE DEVICE ADDRESSED 

TURBO DISK DOS commands are normally sent to a disk drive with a 
device number of 8. If you have two disk drives (with different 
device numbers) TURBO DISK commands can be redirected, by using the 
following command (n is the new device number): 


TURBO DISK command: @#n 
BASIC equivalent: none 


INITIALISE DISK 

If you are experiencing difficulty reading from a disk, it often helps 
to initialise it. Initialisation reads in important information from 
the disk header, and is automatically performed by the 1541 whenever 
it comes across a disk with a new ID. If you are using two disks with 
the same ID (definitely not recommended) you must initialise whenever 
you change disks to avoid a catastrophe. 


TURBO DISK command: @I 
BASIC equivalent: PRINT#1,"I" 


Do not confuse initialisation with formatting. 


FORMAT DISK 

This command is used to prepare an unused disk for use. Any existing 
information is erased. You must specify a disk name of up to 16 
characters and a two character ID. No two disks should have the same 
ID, otherwise you may corrupt the information on both disks. 


TURBO DISK command: @N:DISKNAME,id 
BASIC equivalent: PRINT#1,"N:DISKNAME,id" 


The ID may be any two characters - you aren't limited to numbers. 
Hence Y¥2, CJ, and %% are all valid IDs. 


If you wish to re-use an old disk containing unwanted information you 
need not enter an ID, only the name. In this case the disk is 
renamed, and the directory cleared but no actual formatting takes 
place. 


COPY FILE 
This command will make a copy of a file on the same disk. 


TURBO DISK command: @C:NEWNAME=OLDNAME 
BASIC equivalent: PRINT#1,"C:NEWNAME=OLDNAME" 


To copy a file from one disk to another, use the FAST COPY command. 


RENAME FILE 
This command will rename an existing file. 


TURBO DISK command: @R:NEWNAME=OLDNAME 
BASIC equivalent: PRINT#1,"“R:NEWNAME=OLDNAME" 


SCRATCH FILE 

If you wish to erase a file from disk use this command. Take care not 
to make a mistake because its effects are irreversible! You can use 
pattern matching to erase more than one file, but be careful in case 
you erase more than you intend. If in doubt you should first use the 
DIRECTORY command to display all of the files which will be scratched, 
i.e. @$:FILE* to display all the files beginning with 'FILE', followed 
by @S:FILE* to scratch them, 


Do not scratch unclosed files (those with a * against them in the 
directory). Use the VALIDATE command instead. 


TURBO DISK command: @S:FILENAME 
BASIC equivalent: PRINT#1,"S: FILENAME" 


You can scratch several files with different names by specifying each 
name separated by a comma, for example @S:ONE,TWO,THR* 


VALIDATE DISK 

This command will trace through the disk and free any blocks not used 

by valid files for later use. In the process, any incorrectly closed 

files (flagged with an asterisk in the directory) are erased. Do not 

use this command if the disk has any user files (indicated by USR in a 
directory listing). 


TURBO DISK command: @V 
BASIC equivalent: PRINT#1,"V" 


ADDITIONAL COMMANDS 


These TURBO DISK commands have no BASIC equivalents: 


DISK RENAME 

To rename a disk, use this shortened form of the FAST FORMAT command. 
The disk name will be changed, but the directory will not be cleared. 
Do not confuse this command with @N:DISKNAME which WILL erase the 
directory! 


TURBO DISK command: £N:DISKNAME 


MERGE BASIC PROGRAM 

This command will merge a BASIC program on disk with a BASIC program 
in memory, interleaving lines according to their numbers. Where both 
programs have line numbers which are the same, the line in memory will 
be replaced with the one from disk. 


TURBO DISK command: €M:FILENAME 


DUMP FILE , 

This command will display a hexadecimal and ASCII dump of the file. 
The current address in the file is shown on the left hand side. The 
next eight bytes starting from the current address are shown to the 
right in both hexadecimal and ASCII. If the file dumped is a program, 
the load address is used as the initial current address in the file. 
To dump sequential or user files use the suffix ',S' or ',U'. 


TURBO DISK command: £D:FILENAME 


DUMP MEMORY 

This command is very similar to DUMP FILE above, except that it will 
dump the contents of the 64's memory from the address specified. The 
address can be entered either in decimal, or in hexadecimal preceded 
by $. Dumping may be paused by holding down the SPACE bar and halted 
by pressing STOP. 


TURBO DISK command: £D:address 


OLD 

If you type NEW by mistake you can recover the program by typing £0. 
If you enter other commands in between NEW and OLD then it may not be 
possible to recover the program. 


TURBO DISK command: £0 


PARALLEL PRINTER DRIVER 

TURBO DISK includes a routine to output to a parallel printer 
connected to the User Port of the Commodore 64 using a cable such as 
PRINTLINK (available from Supersoft). When the printer driver is 
enabled all output intended for devices 4 and 6 will be diverted to 
the User Port. To disable the printer driver type £P-. 


If you use the @Q command to disable TURBO DISK the printer interface 
is left switched on unless it has previously been disabled using £P-. 


TURBO DISK command: €P+ (enable) £P- (disable) 


commands will be disabled, but the fast load, save and verify routines 
will still operate provided you use the standard commands. To disable 
TURBO DISK totally, press RUN/STOP-RESTORE after using the @Q command. 


To re-initialise TURBO DISK after RUN/STOP RESTORE type SYS 49152. 


TECHNICAL NOTES 


TURBO DISK can, unlike many other fast loaders, be used with other 
peripherals (such as a printer) connected to the serial bus. Any 
sprites are switched off at the start of a high speed command and 
switched back on afterwards, but the screen itself remains on. 


In addition to carrying out successful commands more quickly, TURBO 
DISK will save you even more time by detecting and reporting errors 
far faster then the conventional system. Errors will be reported 
automatically when you use the TURBO DISK DOS commands but NOT if you 
use the BASIC equivalents - this is to maintain compatibility with 
programs which themselves check the error channel. 


TURBO DISK occupies memory from $C000 to $CEFF. Zero page memory is 
used carefully, and wherever possible the locations used are the ones 
used by the BASIC interpreter or the kernal for similar tasks. This 
is most important in the fast load and save routines where other 
software might, for example, expect to find the end address of a 
program just loaded by reading the zero page locations that the normal 
load would have used. Other DOS wedges are incompatible with many 
programs because of the use of zero page before a wedge command is 
executed, but TURBO DISK uses no zero page memory unless a wedge 
command is recognised. TURBO DISK will only attempt to interpret 
commands which are entered as the first on a line - and only in direct 
mode. 


SWITCHING TURBO DISK OFF 
To switch off the TURBO DISK commands, type @Q. All TURBO DISK 


TURBO DISK returns compatible error flags in the Accumulator, Carry 
bit and STATUS byte. These include: Device not present, Illegal 
device number, STOP key pressed, Missing filename, Out of memory, File 
not found and File not open. File not open is a normally unused error 
type, which TURBO DISK uses whenever the normal load or save would 
falsely return no error or simply hang up. TURBO DISK commands check 
the error channel automatically, but to maintain compatibility with 
other software this is not done if the fast load and save routines are 
accessed other than through TURBO DISK commands. 


The TURBO DISK DOS wedge intercepts the CHRGET routine. 

The fast load and save routines intercept the LOAD and SAVE vectors. 
The parallel printer driver intercepts the CHROUT, OPEN and CHKOUT 
vectors. 
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